Shareware Overload Trio 2

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / mb1705.zip / SYSOP.DOC < prev next >

Wrap

Text File | 1994-05-23 | 49KB | 1,502 lines

╔═══════════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ W0RLI PACKET RADIO BBS ║ ║ ║ ║ SYSTEM DOCUMENTATION ║ ║ ║ ║ ║ ║ Version 17.X ║ ║ ║ ║ May 23, 1994 ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ by ║ ║ Hank Oredson, W0RLI ║ ║ ║ ║ Edited by ║ ║ John Smith, N6IYA ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════════════════════╝ TABLE OF CONTENTS THE MAIL BOX PROGRAMS ...................................... 1 THE CONFIGURATION FILES .................................... 1 INIT.MB .................................................... 2 MOTD.MB .................................................... 4 DIRS.MB .................................................... 4 XLATE.MB ................................................... 5 DIST.MB .................................................... 6 FWD.MB ..................................................... 7 WILDCARDS .................................................. 11 PORTS.MB ................................................... 11 CRON.MB .................................................... 13 SERVER.MB .................................................. 14 KEYS.MB .................................................... 18 TAG.MB ..................................................... 19 CLOVER OPERATIONS .......................................... 20 MESSAGE MANIPULATION ....................................... 21 PRTLOG.EXE ................................................. 22 ERROR MESSAGES ............................................. 23 (i) THE MAILBOX PROGRAMS MBINIT.EXE initializes shared memory and the databases used by the other programs. It must be run first, before starting DESQview. SERVER.EXE is the main dispatcher for events that happen when a message arrives at the system, or happen at set times. You must have SERVER running for the system to operate properly. MBLISTEN.EXE handles the ports and directs interactions within the system. MBSTAT.EXE provides a system status display. MBSYSOP.EXE provides the sysop with interface to the system without using other system resources. THE CONFIGURATION FILES The following files are text files that contain site-specific information. Edit these files for the proper parameters for your site. In general: Within the following files fields are delimited by any number of blanks and/or tabs. Lines beginning with ";" are ignored and may be used for commentary. Blank lines delimit groups, or are ignored. A ";" placed at the end of a line delimits any trailing comments on that line. These files are read on an event basis with the exception of ports.mb, init .mb, xlate.mb and dirs.mb. These files are read at system startup and any changes will reqire the system to be restarted for changes to take place. The other files can be edited on the fly and the changes will be noticed upon the next event. The one exception is the intenal editor for ports (EP command). This will allow editing of port parameters but these are only temporary in nature and will revert to the saved value in ports.mb upon subsequent system restarts. CRON.MB - Describes actions to be taken at set times. DIRS.MB - File directory area definitions. DIST.MB - Bulletin distribution lists. FWD.MB - Message routing information. HELP.MB - Help command text. INFO.MB - Text of the "I" command. System information. INIT.MB - Information about the system owner. KEYS.MB - Passwords for remote sysops. MOTD.MB - Text of the login message. NEWUSER.MB - Text sent to user at their first login. PORTS.MB - COM port definitions. SERVER.MB - Descibes actions to be taken when a message arrives. TAG.MB - Your message "signature". TEXT.MB - Various configurable prompts, messages, etc. XLATE.MB - Designator translation lists, file-by-BID list, etc. REDIST.MB - Redistribution server address list. RT.INI - Round Table initialization file. (See RT.DOC) (1) The following are created and maintained automatically by the MailBox: BID.MB - Bulletin ID database. MAIL.MB - Message database. WP.MB - White Pages database. YYMM.LOG - The log files. A text file that contains the user log. YYMM is the current year and month. The form $x is a variable text field. The "$x" is replaced by the current value for that text. $a - Number of active MailBox tasks. $B - Users home bbs. $D - The current date. $H - Hang at end of line (suppress carriage return). Use at end of line only. $h - Number of held messages. $I - Sysops name. $L - Number of the last message in the MailBox $M - Message number of current msg. $m - Number of active messages (total minus killed). $N - Number of messages on system. $n - Number of killed messages. $O - Sysops callsign. $Q - Sysops QTH. $T - Current time. $t - Current task ID. $U - Users callsign. $W - Users name. $X - Date user last logged in. $Y - Time user last logged in. $Z - Users zip code. INIT.MB - SYSOP INFORMATION The basic information about the system owner and system operation is contained in the file INIT.MB. Replace the information with your own. If you feel you need to change the various WP lifetimes, be very careful and think through the implications of any such change. Section 1 - Sysop Address Our callsign (no SSID) plus hierarchical location. Our handle. Our qth (city / town only, no advertising please!) Our postal code. W0RLI.OR.USA.NOAM Hank West Linn 97068 Section 2 - WP Global Server Information N6IYA.#NOCAL.CA.USA.NOAM (2) Section 3 - Sysop Call 30 (Number of seconds to ding the sysop page) Section 4 - WP Update Parameters Don't change these unless you have a REAL good reason. Note that 0 means "forever" ... 45 (Days old a "local user" (L) WP entry must be before it is removed) 75 (Days old a "known BBS" (I) WP entry must be before it is removed) 55 (Days old a "user of other BBS" (?) WP entry must be before it is removed) 0 (Days old a "sysop locked" (B,S,X) WP entry must be before it is removed) 50 (How often (in days) to refresh local user data to Global WP server) Section 5 - Local System Parameters Change these to suite the conditions at your location. 7 (Days until Bulletin stale. Marked "O".) 2 (Days until NTS msg stale. Marked "O".) 13 (Days until Personal msg stale. Marked "O") 30 (Days a BID remains valid) 2 (Number of times a message can loop before being held) 20 (Days old for incoming bulletin to be held. Marked "H") 50 (L command max to list) 160 (Limit on number of lines in REQWP response) 5000 (Size limit for WP Update message) YES (Replace hloc on msg with info from @ BBS in WP) 256 (Max files for W commands) YES (B command returns to node instead of disconnect) 6 (Max # tasks that will forward at one time) NO (Use hierarchical locations with leading "#") YES (Normalize all headers) 20 (Size of compressed batch, in k bytes) YES (Use compressed batch forwarding) Section 6 - DesqView API New for version 17.x is the ability to use the Desqview API to handle many of the mailbox tasks. At the bottom of the file are 9 new lines that are to be added. YES (Use Desqview specific calls) (Note: You may choose any favorite text editor for the functions below. It has been tested with Personal Editor and the DOS Edit program that comes with the later versions for MS-DOS. PE amd LI are the Desqview keys for Personal Editor and List.com and are not supplied with the package.) PE (Desqview key that defines the text editor for send message commands) (Note: [..] will disable this function. If you are using PE then set the DV window to come up in full screen mode.) PE (Desqview key that defines the text editor for reply message command) (Note: [..] will disable this function) LI (Desqview key that defines the program to read messages. (Note: [..] will disable this function) (3) (Note: The Desqview keys defined below are only examples. You will have to choose the keys that you desire based on your Desqview setup. For example: in the standard Desqview 386 setup MF calls Quarter Deck Manifest.) ML (Desqview key that defines MBLISTEN.EXE) MU (Desqview key that defines MBUSER.EXE) MF (Desqview key that defines MBFWD.EXE) MT (Desqview key that defines MBSTAT.EXE) MS (Desqview key that defines MBSYSOP.EXE) Section 7 - Control Keys F (Control character to kick user off of system.) E (Control character to return from talk mode.) E (Control character to interrupt user and talk.) (Note: these keys can be defined as the function keys F1, F2 etc.) (Note: a little history...orginally called the "Cat Keys". During) (orgination of the program 2 new cats were aquired and had a propensity) (to walk on the keyboard. The odds of a single key being depressed) (during these excursions was extremely high and as such could and would) (place the bbs in the strangest places. Hence the orgination of 2 key) (combinations to perform these functions...js...) MOTD.MB - THE LOGIN MESSAGE The login message is contained in the file MOTD.MB. Varible text fields can be used in MOTD.MB, just as in TEXT.MB. This file is also a good place to inform users of any changes that have taken place on the system or the network. Example MOTD.MB Hello $W, Welcome to the $O Mailbox, part of the OPEN Network. This system is Operated by $I in $Q, Oregon. You last connected at $Y on $X; your Home BBS is $B Type H for Help. Type I for Information about this system. Note: The RT Server is now on line at Node WLINN. Connect to the switch and enter RT. Have fun and enjoy! $I DIRS.MB - FILE DIRECTORY AREAS The first field is a single character path ID, followed by "D" if downloading is allowed, and "U" if uploading is allowed. The second field is the path, with trailing '\'. The third field is the name of the path, as shown to the user. Example DIRS.MB ADU \bulls\arrl\ ARRL Bulletins BDU \bulls\baycom\ Baycom Exchange Newsletter CD \bulls\mbdoc\ Mailbox Sysop Documentation DU \bulls\sysop\ Upload file area for sysop only files. (4) XLATE.MB - TRANSLATION, FILE-BY-BID, HOLD LISTS, ETC Each line in this section instructs the MailBox to take some action when it receives some specific kind of message. Each line has several fields. The first field tells WHAT action to take. The second and following fields tell HOW to take that action. Note that the character string matches allow wildcards (See WILDCARDS below). If more than one action applies to a given message, they take place in the order they are given in XLATE.MB. Action code Meaning B File message by BID H Hold any messages TO, FROM, or @ this callsign. HT Hold any messages TO this callsign. HF Hold any messages FROM this callsign. HA Hold any messages @ this callsign. HL Hold all locally entered messages. This include personal type messages. R <old TO> <old @> <new TO> <new @> - Address translation information. The 1st or 2nd fields may use wildcard matching (see WILDCARDS below). A single "*" in the 3rd or 4th fields means "leave unchanged". T Set time-to-live for this bulletin class. If set to 0, will kill after forwarding. Examples: b arl* \bull\arrl\ - File ARRL bulletins by BID. k sale allusa - Kill SALE @ ALLUSA after forwarding. hf wb6oco - Hold any messages from WB6OCO ht ffnet - Hold any messages to FFNET r * w0rli * - Remove the "BBS" if it is this BBS. r * worli * - Fix typical typo. r * rlimb * - Fix typical typo. r * orgb * or - Any message @ "ORGB" becomes @ "OR". r sysops * sysop * - Any message to "SYSOPS" becomes to "SYSOP". r all amsat amsat allusa - Bulletins to ALL@AMSAT become AMSAT@ALLUSA t wx pdx 2 - Bulletins to WX@PDX will go away in two days. t * amsat 10 - Bulletins @AMSAT will go away in ten days. Note: These are typical examples and for the local area only. Configure to your specific area, callsign and alias as needed. In addition, corrections can be made to other traffic coming thru the system to correct user initiated mistakes. Ultimately, it is the sysops responsibility to inform the users and/or sysops that these errors are occuring and that corrective action needs to be taken. (5) DIST.MB - DISTRIBUTION LISTS The file consists of any number of lines, where each line has: TO AT call1 call2 call2 ... If a message matches the TO and AT (with wildcards - see WILDCARDS below), then it will be distributed to the calls listed on the rest of the line. There can be up to 14 calls per line. If you have more than 14 calls for a single distribution, simply create two lines. Distribution lists are cumulative. Note that if you put your own call in the list, the message will not automatically kill until after you have read it. It will be "distributed" to you. The message is not forwarded to the stations in the list any special order. If a station is busy then the MailBox will try again the next hour. An "L ;" listing of a message with a distribution list shows the sysop the status of forwarding to each station on a second "cc:" line. The calls to which the message have been sent have an asterisk before them. Distribution list example: * allor ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn * allors w7dcr n7dxt wa7shp * allusa ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn * allusa w7xyz w7xyz aa7qq * allusw ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn * amsat ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn * open ka7agh kb7dbd wa7sjn * pdx ka7agh n7chr kb7dbd wa7shp wa7sjn n7vyn * or ka7agh n7chr kb7dbd w7dcr n7dxt wa7shp wa7sjn n7vyn * sunami n7hae w7vtw * wwgb ka7agh n7chr kb7dbd wa7sjn n7vyn sysop * w0rli * net ve3gyq w3iwi wb1dsw w0ljf k0jjv ad8i * usa wa7sjn n6iya w5xo Things to note: A message addressed SYSOP @ OR will hit two distribution lists, "sysop *" and "* or". It will thus get all the calls in both lists as it's distribution. From version 16.8 there will only be one forward of a message with multiple lists. It is possible to distribute messages to H components such as USA, OR and WA as these are treated as seperate items. H components are not considered for the domain in which the station exists. To forward messages to other domains the syntax SB target @ XX.XX will use the H component to move to other domains and then distribute on the @XX component. The distribution list file is read "fresh" for each message, thus you can alter it "on the fly" while the system is running, IF your text editor supports file sharing properly. If it does not, you may get "sharing violation error" when attempting to write the file back out from your editor. (6) In fwd.mb, the callsign from the dist.mb list must be prefixed with "$" to cause the bulletins to forward. This is done so that you can forward personal messages first, bulletins last. FWD.MB - AUTOMATIC FORWARDING The file FWD.MB contains information that drives the automatic forwarding of messages. If the file does not exist, no forwarding is done. Forwarding is done when some item in CRON.MB triggers it, or by sysop command. FWD.MB consist of a number of lists, and a "forwarding script" associated with each list. Each list has the information for one MailBox to which you will forward. The script associated with the list tells your MailBox how to connect to the MailBox you will forward to. The list contains information that describes which messages will forward to that MailBox. Each list is terminated by one or more blank lines. A line starting with semi-colon will be ignored, you can use this for commenting your fwd.mb. Trailing space plus semi-colon can be used to add a comment to the end of a line. I have included an example FWD.MB file in the release package. The overall structure of FWD.MB is thus: Script1 List1 Script2 List2 ... etc. Routing lists. Each list has any number of callsigns, designators, or sublists. There can be up to 24 callsigns or designators on each line. Thus, a list will look like: ntsmn ntssd w0qrm k0cj or: ntswa 98* w7xyz aa7abc @hf.fwd (7) Format of the list header. Call: <callsign> Group: <group 1> <group 2> ... (note: not to exceed 6 characters in length) Port: ID Pre: <command> Post: <command> Con: <command> Timeout: <seconds> Message: <max size> Batch: <max size> Notes: If a Port: is not specified, any free switch port will be used. If a Batch: <size> is not specified, the default batch size from INIT.MB is used. In addition if Batch: <size> is set to "0" then compressed fwding will not occur for this connect. The Connect Script ("Con: <command>") can have the following commands: For a CLOVER normal link: CN CALL For a CLOVER robust link: CR CALL For a direct connect to the MailBox you wish to forward to: CC 3 N7HAE <- Means "downlink to n7hae from the node on its port 3" To connect to a distant MailBox running the g8bpq switch, when you are using the g8bpq switch also just connect to that MailBox call: NC WA7SJN Some more examples: NC W6NR-11 NC N7EQN-10 via A6DIG Summary of script items in FWD.MB CN call - Connect TO this call using normal CLOVER link. CR call - Connect TO this call using robust CLOVER link. NC call - Connect TO this call FROM a node. X n cmd - Control transceiver before or after connect. S text - Send this text. R text - Receive this text. R! - Receive any text. For additional Pre: and Post: commands for the HAL PCI-4000 CLOVER board, and for transceiver control commands, see the section on CLOVER. Pre: items give TNC commands to be executed BEFORE the connection: Pre: retry 10 Pre: maxframe 3 Pre: frack 8 (8) There is an additional command that can be issued using the pre: format This is the W command [wait]. This value is expressed in seconds and can be used to delay the processing of further commands while the system is processing a previous command. An example is wait period introduced to allow radio to go to another frequency. Pre: W 2 < wait 2 seconds before processing the next command. Post: items give TNC commands to be executed AFTER the disconnect: Post: retry 3 Post: maxframe 7 Post: frack 3 Be very careful using Pre: and Post: items. The MailBox assumes that the TNC is setup in a "standard" manner. If you change CR, CP, or SE in a script, it could cause problems. Timeout:, Message:, and Batch: items are used to place limits on what will forward when the list is used. Message: nnnn - Will limit the size of messages forwarded. Examples: Message: 20000 Keep any message larger than 20k bytes from forwarding. Batch: 20000 If batch compression is in use, set batch size to 20k bytes. Pre: S and Pre: R items are used to forward in unusual situations, so that you can handle networks which do not use NET/ROM . S and R items come in pairs: An S item is a line to send: Pre: SBBS An R item is the expected response: Pre: R#SBAY1:N7EQN-10} Connected to #WWORM:WB6FFC-1 In the case that ANY response is valid use: Pre: R! (9) As an example, the script for W0RLI in Santa Cruz using NET/ROM to connect with KA6IQA in San Diego might be (using all the possible script features). Call: ka6iqa Group: south socal Port: b Message: 2000 <- Don't forward messages larger than 2K. Timeout: 240 <- Use 4 minute timeout for this forward. Batch: 0 <- Do not use compression for this forward. Pre: retry 10 <- Tough path, retry a lot. Pre: maxframe 3 <- And don't send very many packets. Post: retry 3 <- Put things back to normal after this forward. Post: maxframe 7 <- Ditto Con: nc w6amt-1 <- Connect to the local NET/ROM backbone node. Con: nc w6amt-3 <- Connect to the NET/ROM closest to KA6IQA. Con: nc ka6iqa v w6amt-4 <- Connect to KA6IQA. ka6iqa <- Forward messages TO or AT KA6IQA. 91* <- Forward zip codes starting with 91. $ka6iqa <- Then forward bulletins to KA6IQA. Sublists. At any place in the FWD.MB file you can refer to another file. The contents of the file is treated exactly as if it was in the FWD.MB file. This feature is very useful when you have several alternate paths to a given location. FWD.MB need only contain the connect Script for each different path, and a list containing a reference to the file which contains the list contents. A sublist file is given by a line starting with "@". The rest of the line is the device, path, and file name of the sublist. Example: Call: n4chv Port: c Con: NC N4CHV N4CHV @C:\BBS\HF111.FWD @C:\BBS\SILICON.FWD Call: w6cus Port: d Con: NC W6CUS-1 NI6A @C:\BBS\SILICON.FWD Entry qualifiers. A qualifier is appended to the line it affects. There is one qualifier at this time: " /TSSEE" where SS is the start hour and EE is the end hour. This qualifier causes the line to be ignored if the current time is not within the time window. (10) WILDCARDS AND SPECIAL "CALLSIGNS" IN LISTS. When the designator in FWD.MB is compared to the TO or @ BBS call, the characters '?', '*', '@', '!', '+', '"' in the designator act as wildcards. Wildcards matches are supported in many places. With wildcards we match with more than a straight comparison. Special characters in the pattern are: * -- Matches 0 or more characters of any type. @ -- Matches any alpha character (a..z, A..Z). ! -- Matches any digit (0..9). + -- Matches any alphanumeric character (A..z, A..Z, 0..9). ? -- Matches any single character. " -- Escape. The next character in the pattern must match the character in the target exactly. Wild cards will not be interpreted. Examples: 97* -- Will match anything starting with 97 such as 97068, 97123, 97ABC, and 97. 97??? -- Will match anything that starts with 97 and is 5 characters long. 97068 will match but 9706 will not. 97!!! -- Will match anything that starts with 97 and has 5 digits. 97068 will match but 97ABC will not. @!@@@ -- Will match a 5 character US callsign such as W0RLI, N6IYA, etc. VE!@@@ -- Will match standard Canadian callsigns. "!"* -- Will match *! !* -- Will match anything that starts with a digit. Note that within FWD.MB, you cannot use @ as the first character, since @ is used to branch to another file. This will be changed in some future release of the MailBox. The callsign "*" is special. Putting it into a list means for forward all messages not addressed to users of the system. It is a shorthand way to set up a "local" bbs, which forwards all outgoing traffic to a single "full service" bbs. If you use this feature, there should be NO other callsigns or designators in the list. To forward bulletins, the designator that must be used is the callsign of the station (as used in dist.mb) with "$" prefixed to it. If you had "w0rli" in dist.mb, you would put "$w0rli" in fwd.mb. This allows you to position the bulletin forwarding in the forwarding sequence in any way you like: first, last, somewhere in the middle. PORTS.MB - PORT DEFINITIONS There must be a definition for your printer: Printer type can be one of LPTx, COMx, or NONE Examples: Printer NONE Printer COM5 Printer LPT2 (11) The Console definition has been eliminated in version 17.4. It is redundant as mbsysop is always running. For each port available to the MailBox, there must be a definition. The first field is the port type: SWITCH - This port has a G8BPQ node virtual TNC connected. PCI - This port is a HAL PCI-4000 card. The second field is the pot indentifer of the first com port that can be used for forwarding or in terminal mode. The 3rd field is the number of the first COM port as defined by the ytnc configuration in your autoexec.bat file. The 4th field is the number of COM ports to use for the mailbox. Further fields are used for ports that require more information. The HAL PCI-4000 card requires two file names: the DSP microcode and the Control Processor microcode. Examples: SWITCH A 1 1 Is Switch port, using 1 port (A) and start with COM 1. SWITCH G 2 12 Is switch port, using 12 ports (G-R) and start with COM 2. PCI C 360 \pcc\pcc.lod \pcc\pcc.s28 Non-Switch CLOVER port with board loaded at address 0360H and load the the files PCC.LOD and PCC.S28 at start up. This line is followed by information about how the port is to be used: Watch Monitor - See monitoring. Watch User - See what user is doing. Watch Commands - See tnc commands. BBS Only - Only stations marked as BBS may connect. Calls Legal - Only "legal" callsigns may connect. Calls Any - Any callsign may connect. Compression On - Use compressed batch forwarding, if possible. Compression Off - Do not use compressed batch forwarding. Timeout xxxx - Connect timeout, in seconds. DTimeout xxxx - Disconnect timeout, in seconds. Errlimit xxxx - Number of command errors allowed before user disconnected. Init xxxx - Command to be sent to TNC at startup. Discon xxxx - Command to be sent to TNC at user disconnect. Connect xxxx - Command to be sent to TNC at user connect. Note: "Init", "Connect", and "Discon" commands are handled in the same way as Pre: and Post: commands in FWD.MB, see the FWD.MB documentation for details. See also the section on CLOVER for further information on HAL PCI-4000 commands. (12) Examples: SWITCH A 1 9 - Switch port, using 9 ports (A-I) Starting with COM 1 Watch Monitor - Turn Monitor on Watch User - Monitor user Watch Commands - Echo TNC Commands to screen BBS Only - Only BBS can use this port Calls Legal - Accept only legal calls Compression On - Use compression Timeout 300 - Timeout port after 360 seconds of inactivity DTimeout 30 - Timeout port after 30 seconds if <DACK> not received Errlimit 5 - Allow 5 command errors before disconnect Init echo off - Turn ECHO off Init flow off - Turn FLOW off PCI B 360 \pci\pci.lod \pci\pci.s28 Load CLOVER board as PORT B address 0360H Watch Monitor - Turn on Monitor Watch User - Montior User Watch Commands - Echo TNC commands to screen BBS Only - Only BBS can use port Calls Legal - Accept only legal calls Compression On - Use compression Timeout 180 - Timeout port after 180 seconds of inactivity DTimeout 10 - Timeout port after 10 seconds if <DACK> not received Errlimit 5 - Allow 5 command errors before disconnect Init BF - Set board fast bias Init R 9 - Set retry count to 9 Init S 0 - Set chat threshold to 0 Discon X 1 SC1; - Upon disc send resume scan command on COM 1 CRON.MB - TIMED EVENTS The file CRON.MB describes timed events to SERVER.EXE Each line in CRON.MB takes the form: <time clause> <action clause> The time clause takes one of two forms. At H1 At M1 This causes the action to take place at a specific time. From H1 to H2 Each M2 At M1 This casues the action to take place periodically. The "Each M2" may be left out. If it is not present, "Each 60" is assumed. Note that the "At" qualification applies minutes in the "Each" period. "Each 10 At 20" for example does not make sense, since there will never be a "20th minute" in a ten minute period. However, "Each 20 At 10" does make sense, as there is a "Tenth minute" in every 20 minute period. The action clause takes one of the following forms: GM - Delete killed messages from the system. J - Save the list of recent connects. (13) Clean - Generate the WP Update message, kill old bulletins, remove stale BIDs from BID.MB. Note that you MUST have and entry for CLEAN for the system to operate normally. Tofwd - Rebulid the "to forward" list if it is full. Beacon - Send the "Mail for:" beacon on the switch ports. For the following <Callsign> and <Group ID> must be the same as specified in FWD.MB Forward Call <Callsign> - Forward to a particular station. Forward Group <Group ID> - Forward to all stations that use the group ID. Must match <Group ID> in Fwd.mb and cannot exceed 6 characters in length. Poll Call <Callsign> - Poll the callsign for reverse forwarding. Poll Group <Group ID> - Poll the <Group ID> for reverse forwarding. Must match <Group ID> in fwd.mb and cannot exceed 6 characters in length. Import <file> <format> - Attempt to import messages from a file. See SERVER.MB for details of <format>. Run <program> - Run a program in a Desqview window as defined by the DV key. Examples: To Import messages from the file MSG.IN at ten minute intervals starting at minute 5 all day: from 0 to 23 each 10 at 5 import msg.in h8 SERVER will attempt to import at 00:05, 00:15, 00:25, etc. To save the g8bpq node list every 20 minutes: from 00 to 23 each 20 at 7 run S1 (Formerly BPQNODES.BAT>NUL) Every hour, at 23 past the hour, forward to group CLOVER. from 00 to 23 at 23 forward group clover See file CRON.MB for more examples. SERVER.MB - DEFINITIONS FOR SERVERS SERVER.MB describes what actions to take when a message arrives at the system. It contains information that drives Export/Import of messages and the running of external servers such as FILEX. If the file does not exist, no Export/Import is done and no servers are run. (14) In version 17.x you will be required to setup external servers as Desqview programs (See Desqview section in Install.doc). The Desqview keys defined in the ADD A PROGRAM section will be used to define the server and placed on the line instead of the path and program name. For example: In Desqview the Filex Server has been defined as S2-PIF.DVP. The keys to initiate the program are S2 in the Open a program menu in Desqview. The line in SERVER.MB that used to be: filex.out 8 \mbexe\filex.exe filex.in 8 filex reqdir reqfil will now read: filex.out 8 S2 filex.in 8 filex reqdir reqfil External Server operation: Automatic Export/Import of messages. There are three kinds of servers S1 does only export. S2 does export then runs a program. S3 exports, runs a program, then imports. The information required in SERVER.MB, and the type of processing done, is slightly different for each type. S1 Server: An S1 server checks the message against the list, and exports it if there is a match. This is typically done to archive all messages: You specify two fields in SERVER.MB for an S1 server: out_file out_format Example: arch.msg rh8 * S2 Server: An S2 server exports in the same manner as an S1 server, but runs a program after the export. You specify three fields in SERVER.MB for an S2 server: out_file out_format program_name Example: check.msg rh8 \utils\headers.exe * (15) S3 Server: An S3 server exports, runs a program, then imports. A complex server first exports any messages that match the designators in the designator list. Then the server process is run. Then any generated messages are imported. Note that, unlike a simple server, all three functions always take place. Thus a complex server can function (for example) to transfer messages both ways between the MailBox and smtp. A list like the one below, placed into SERVER.MB, is required to define a complex server. If the server file extension is .EXE or .COM, then COMMAND.COM is not loaded. If the server file extension is .BAT, then COMMAND.COM is loaded, and you must take it's memory requirement into account. Most servers are S3 servers. You specify five fields in SERVER.MB for an S3 server: out_file out_format program_name in_file in_format Example: echo.out h8 S2 echo.in h8 echo Available format modifiers are: 8 - Use RFC-822 headers. H - Include the BBS message headers. On import, there will be no blank line between existing headers and the new header created with the new message. O - Use the old style "standard" (WA7MBL) export/import format. R - "Read only" - do not kill the message, or mark it as forwarded when it is output to the server. If no modifier is given, then ONLY the message text is put into the file. Wildcards and special "callsigns" in lists. See WILDCARDS above for a description of how to use wildcard characters. Sublists. At any place in the SERVER.MB file you can refer to another file. What happens is that the contents of the sublist are treated exactly as if they were in the SERVER.MB file. A sublist is given by a line starting with "@". The rest of the line is the device, path, and file name of the sublist file. File formats. The following is an example export file produced using format H8. Things to note about this file: 1. There is a blank line following the RFC-822 header, and another following the MailBox header. (16) 2. The special header item "X-msgtype" is used to show whether the message is a Bulletin, is Personal, or is an NTS message. 3. The special header item "X-BID" is used to show the BID, if the message has one. 4. The file can contain multiple messages. Date: 12 Mar 89 17:09 <- Date at originating MailBox Message-ID: <8988@N6IYA> <- Message number at orig MailBox X-msgtype: P <- Message type (B, P, T) X-BID: 1234_N6IYA <- BID, if the message has one. From: N6IYA@N6IYA <- User at orig MailBox To: ECHO@W0RLI.OR.USA.NA <- Full location as sent Subject: Testing path turnaround. <- Message title <- Blank between RFC-822 hdr and MailBox hdrs R:890312/1722z @:W0RLI.OR.USA.NA West Linn #:3571 Z:97068 R:890312/1709z @:N6IYA.CA.USA.NA Felton #:8988 Z:95008 <- Blank between MailBox hdrs and text. Test message. <- Message text. ../EX <- ".." added, not there in actual format It appears that there will be a large number of servers created. These are servers I have heard about. Some are ready for use, some are in the planning/coding stage. ECHO - "echo" the message back to sender for path testing. REQDBF - Database server by K0ZXF. FILEX - "File eXchange". Upload, Download, directory listings. REQDIR - Request directory information. The FILEX server handles REQDIR. REQFIL - Request a file. The FILEX server handles REQFIL. REQQSL - Request qsl manger info for dx callsign. REQWP - Request WP information. Remote access to the I, I@, IH, and IZ commands. RLIMON - Automated sysop functions from KJ4LQ. REQQTH - Request name/address for callsign. REQCB - Callbook info from the J-Comm or RT Systems databases. SMTP - smtp/BBS message interface. Here is an example for a user-written server, using only DOS batch commands. This server will print selected messages as they arrive. 1. In the distribution lists for any messages you want printed, add an extra callsign PRTIT. (17) 2. In SERVER.MB add the lines: PRTIT.OUT H8 PRTIT.BAT PRTIT Where PRTIT.BAT contains: PRINT PRTIT.OUT DEL PRTIT.OUT KEYS.MB - PASSWORDS FOR REMOTE SYSOPS Sysop passwords for the MailBox. Designed by Geert Jan de Groot, PE1HZG, Eindhoven, Holland Remote sysop is a nice way to split the work involved with managing a BBS among several people. However, in the past, some crooks used the calls of some (remote) sysops and erased all files... I added a netrom-like verification procedure to check if a remote sysop is really who he says he is. The procedure is as follows: Each 'trusted person' has his own personal key, which consists of an array of 10 by 10 random letters and numbers, like this: Key for: PE1HZG 01234 56789 0 tBixT 03ytR 10 9yD6s HfC0c 20 ze28q 70nL4 30 7OczX 1fEdW 40 6R8BU cao07 50 OWJ1m lTo2q 60 XLHGl NCDdF 70 2wXUO rjwDL 80 uh7P4 fsYiO 90 mQPjY zXxAM On the @ command, the BBS gives 3 lines of 8 numbers, like this: 2354 - L#4912 - PI8ZAA-BBS > @ (user gives sysop command) 2 55 26 46 24 52 79 77 (BBS verification ) 41 23 94 23 86 56 54 23 75 69 3 97 77 49 64 38 il0aqJLw (user response to 1st line) N#182 - L#4912 - PI8ZAA-BBS > (success - sysop prompt) A remote sysop translates ONE (just random, first, second or third) line into the matching characters using his personal key. Which line matches, does not matter. If the sent response-string matches, the user is who he says he is and goes to remote sysop status. If not, nothing happens. (18) Bad guys who monitor the BBS, see an answer to 3 possible questions, and don't know what line matches the response string, so they can't re-build the key matrix owned by the remote sysop. This, of course, only works if remote sysops randomly pick the first, second or third line to translate. (However, using statistics, people can deduce the original key if they have enough data. Crypt wizards say it may take 100 sessions before such an attempt may be successful. If you go sysop 1 time a day at most, and change keys every 2 months, they should not be able to get sysop status.. time will tell!) In the BBS, there is a file called KEYS.MB which has records of this format: PE1HZG tBixT03ytR9yD6sHfC0cze28q70nL47OczX1fEdW6R8BUcao07OWJ1mlTo2qXLHGlNCDdF2wXUO Each remote sysop has his own entry in the keys.mb file, and should have different keys. At PI8ZAA, the actual keys are generated by machine, a small basic program will do the trick. Of course, NOBODY should EVER consider downloading the KEYS.MB on air! If a person with a unknown call tries to get sysop status, simply NO response-string matches. I did this because it was easier and maybe it keeps the bad guys puzzled.. If the password is a single "*", then that user may become sysop without any password being required (added by W0RLI). Note: For each station to have sysop privledges they must also be noted in WP.MB as being a sysop. Use the EU CALL command to toggle the sysop key. TAG.MB - MESSAGE TAGGING The file consists of any number of groups, where each group has: Header line <any number of text lines> . <a line containing only a period, this terminates the text> Header line <text> . etc. The header line contains a single character to indicate when to apply the tag, and a list of callsigns, (no more than 15). The character at the start of the line can be: L - Apply the tag to locally entered messages (it's your signature). R - Apply the tag to messages received from these stations. T - Apply the tag to messages sent to these stations. (19) CLOVER OPERATIONS In terminal mode there are a small number of commands you can use to control the operation of the PCI-4000 and it's radio. These commands are also available in FWD.MB scripts, and as "Init", "Connect", and "Discon" commands in PORTS.MB. CH n - Use voice subchannel n (1 to 5). CN <call> - Initiate a normal link to <call>. CR <call> - Initiate a robust link to <call>. CW <on/off> - Turn CWID on or off. RC <number> - Set CCB retry count. RN <number> - Set NORMAL retry count. RR <number> - Set ROBUST retry count. BF - Set fast bias. BN - Set normal bias. BR - Set robust bias. S <nn> - Set chat threshhold to nn (0 is normal). *** Serial port control of the radio: These commands support COM1 through COM4, at the following addresses: COM1 - 3F8 COM2 - 2F8 COM3 - 3E8 COM4 - 2E8 Note that the COM port baud rate, etc. must have been previously set (using for example the DOS MODE command), and that CTS/RTS handshaking is used. If CTS/RTS is not required, those pins must be jumpered at the PC end of the cable. Serial Port Commands "XI" command: Used to send initialize the serial port used to control a radio. XI p baud parity bits stop Example: XI 1 4800 N 8 2 Kenwood Radio Control "X" command: Used to send commands to a Kenwood radio using the Kenwood interface. X p cmd cmd ... - Send commands out serial port p. Examples: (20) Pre: X 1 FN2; -> Using COM1, tell transceiver to use memory channels. Pre: X 1 SC1; SC0; MC023; -> Start scan, stop scan, QSY to memory channel 23 before making this connect. Post: X 1 MC001; -> QSY to memory channel 1 after disconnecting. Yaesu Radio Commands "XY" command: Used to send commands to a Yaesu radio using the CAT system. XY p opcode par1 par2 par3 par4 The opcode and par are the numbers per the Yaesu CAT documentation. Bytes are sent in reverse of the order given, i.e par4 par3 par2 par1 opcode. If the CAT opcode does not require all parameters, you may leave them off. Examples: XY 1 2 12 0 0 0 -> Set radio to memory channel 12 XY 1 2 12 -> Set radio to memory channel 12 Terminal Commands The following are available only in terminal mode. T - Send test tones. I <a> <b> - Initialize the board using the PCC.LOD file given as <a> and the PCC.S28 file given as <b>. MYCALL is set, and other parameters required for correct MailBox operation are also set. I - With no file names given, defaults to using the files \PCC\PCC.LOD and \PCC\PCC.S28 < file - Read commands from file. MESSAGE MANIPULATION One problem that confronts the sysop from time to time is a message that has the wrong type, wrong distribution list or wrong address. There are 2 ways to correct this problem. 1) Use the "E" command and edit the message header. Because of the many possibilities, this command is limited in scope. For simple changes, such as "unkilling", a message , it will work. It will not create a new distribution list. It will however allow you to edit the message header to change the "TO", "@BBS", "TITLE FIELDS" and the various message status parameters. The paramaters include changing the message type (B,P or T), whether the messages is held, killed, forwarded, read or is old (H,K,F,Y,O). The command syntax is E message number <CR> T New to callsign or designator b bbs and/or HLOC designator H New message title S option (Options are BFHKOPTY) (21) Each of the above commands must be done singularily and cannot be grouped. For example: T N6HAM <cr> When finished a <CR> ends the editing session for that message. 2) To create a new message and any distribution that may be associated with the message, it will be necessary to copy the message to a file and then create a new message. Although this sounds fairly complicated it is a simple process and requires the use of 4 commands. The F, M, K and Z commands. Step 1 Convert the message to a file...to do this use the F command. F 325 TEMP.TXT This puts message # 325 into a file called TEMP.TXT in the directory of \bbs. Step 2 Convert the file into the new message....to do this use the M command. M(P,B,T) TEMP.TXT Callsign @ BBS The system will then prompt you for a title. You can enter the orginal title or one of your choosing including a blank. Step 3 Delete the orginal message with the K command. K 325 Step 4 Delete the temporary file using the Z command. Z TEMP.TXT PRTLOG.EXE - THE LOG FILE ANALYZER A utility to analyze the system created log files. This utility will process the data contained in the log files and allow the sysop to analyze the information to determine how the system is being utilized, what type and how many messages have passed through the system. Entering PRTLOG from the DOS prompt will give the sysop a menu of items on how to use the utility. PRTLOG <cr> PRTLOG outfile -opts Option: C - Report by callsign L - Detail listing D - <from> <to> - Inclusive date range. i.e. -d 920812 920923 F - <list file> - File of calls to analyze For example: PRTLOG aug.log -c <cr> will analyze the files specified by callsign. (22) PRTLOG aug.log -l will give a detailed listing of all events in the specified log files. PRTLOG aug.log will give a summary report of the specified log files. PRTLOG will prompt for the log files to be analyzed. PRTLOG TEST.LOG <cr> Log File (or enter when done:) at this point enter the name of the log file to analyzed in the format: yearmonthLOG.number i.e.: 9301LOG.1 <cr> When all the files to be analyzed are entered follow with a <cr> and the output file will be created. ERROR MESSAGES Starting in version 17.5 error messages will be displayed on the screen indicating certain system statuses. These messages are for debugging the system. If you encounter these messages please note them before attempting to do anything else with the system if they fail to go away. If they are indicated in many windows this is indicative of a system crash and server is usually not running. The messages will appeare only once in a given window after the system has attempted to a lock on a record or mail.mb 10 times every 2 seconds. If the locks cannot be accomplished and the messages appear then you should attempt the recovery process. The messages Message record nnnn locked (read) Message record nnnn locked (write) Message record nnnn locked (read/lock) MAIL.MB header locked (read) MAIL.MB header locked (write) MAIL.MB header locked (read/lock) (23)